home *** CD-ROM | disk | FTP | other *** search
/ NOVA - For the NeXT Workstation / NOVA - For the NeXT Workstation.iso / SourceCode / AdobeExamples / NX_Clock / README < prev   
Text File  |  1992-12-19  |  2KB  |  44 lines
  1.  
  2. README file for the Clock application.
  3.  
  4. The Clock application looks at graphic state objects (gstates) and user objects.
  5. This is done within the context of a clock. The hands of the clock each have a
  6. gstate associated with them. The gstates and the path descriptions for the hands
  7. are referenced using user objects. (The paths are stored in the server.) Although
  8. the use of a gstate for each hand of the clock is a little gratuitous, the setup does
  9. provide a closer look at how gstates work.
  10.  
  11. Gstates are primarily useful for windows and views that will be composited onto
  12. other views. The reason for this is because a gstate contains a reference to the
  13. device. The device for a window is the raster memory. As a result, the gstate
  14. provides a way to focus the drawing on a particular area in raster memory. (The
  15. composite operator uses the gstate to locate the raster image for the source.)
  16.  
  17. Gstates also provide an easy way to install an arbitrary graphic state as the
  18. current graphic state instead of having to set each parameter explicitly.
  19.  
  20.  
  21. Below lies an annotated list of the files used in the application. 
  22.  
  23. Animator            - A subclass of Object taken from the StopWatch application
  24.                     that was once in the NeXTDeveloper directory. It provides
  25.                     the call backs for the one second ticks.
  26. ClockApp        - A subclass of Application that creates the clock window.
  27. ClockView        - A subclass of View that manages the drawing of the clock
  28.                     face and the hands. Contains a reference to an NXImage
  29.                     object which holds the rendered image of the clock face.
  30.                     This object is composited into the window and then the
  31.                     hands are drawn atop at each clock tick.
  32.  
  33. ClockViewWraps.psw    -  Wraps for drawing the clock face, detecting a hit on
  34.                     the alarm hand and defining objects in the server.
  35.  
  36.  
  37. Topics of interest from the Clock application:
  38.  
  39. Using a static user path description (ClockView)
  40. Defining user objects (ClockView)
  41. Defining graphic state objects (ClockView)
  42. Drawing into an offscreen window and compositing from it (ClockView)
  43. Scaling the Clock (ClockView)
  44.